package com.shop.mapper;

import com.shop.entity.OrderItem;
import org.apache.ibatis.annotations.Delete;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Select;

import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 订单项数据访问层
 * 
 * 提供订单项相关的数据库操作接口
 * 
 * @author Shop Management System
 * @version 1.0
 * @since 2024-01-01
 */
@Mapper
public interface OrderItemMapper {
    
    /**
     * 查询所有订单项
     * 
     * @return 订单项列表
     */
    List<OrderItem> findAll();
    
    /**
     * 根据ID查询订单项
     * 
     * @param id 订单项ID
     * @return 订单项信息
     */
    OrderItem findById(@Param("id") Long id);
    
    /**
     * 根据订单ID查询订单项
     * 
     * @param orderId 订单ID
     * @return 订单项列表
     */
    List<OrderItem> findByOrderId(@Param("orderId") Long orderId);
    
    /**
     * 根据时间范围查询订单项
     * 
     * @param startDate 开始时间
     * @param endDate 结束时间
     * @return 订单项列表
     */
    List<OrderItem> findByDateRange(@Param("startDate") LocalDateTime startDate,
                                   @Param("endDate") LocalDateTime endDate);
    
    /**
     * 获取商品销售统计
     * 
     * @param startDate 开始时间
     * @param endDate 结束时间
     * @return 销售统计列表
     */
    List<Map<String, Object>> getProductSalesSummary(@Param("startDate") LocalDateTime startDate,
                                                    @Param("endDate") LocalDateTime endDate);
    
    /**
     * 保存订单项信息
     * 
     * @param orderItem 订单项信息
     * @return 影响行数
     */
    int save(OrderItem orderItem);
    
    /**
     * 更新订单项信息
     * 
     * @param orderItem 订单项信息
     * @return 影响行数
     */
    int update(OrderItem orderItem);
    
    /**
     * 根据ID删除订单项
     * 
     * @param id 订单项ID
     * @return 影响行数
     */
    int deleteById(@Param("id") Long id);
    
    /**
     * 根据订单ID删除订单项
     * 
     * @param orderId 订单ID
     * @return 影响行数
     */
    @Delete("delete from shop_management.order_item where order_id = #{orderId}")
    void deleteByOrderId(@Param("orderId") Long orderId);
    
    /**
     * 批量保存订单项
     * 
     * @param orderItems 订单项列表
     * @return 影响行数
     */
    int batchSave(@Param("orderItems") List<OrderItem> orderItems);

    void insert(OrderItem orderItem);

    @Select("select * from shop_management.order_item where product_id = #{id}")
    OrderItem getByProductId(Long id);
}